home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_28 / readme < prev   
Text File  |  1995-01-01  |  9KB  |  230 lines
  1.  
  2.                                          A d v a n c e d
  3.                   ▄▄▄▄  ▄▄▄▄▄    ▄▄▄▄  ▄▄    ▄▄ ▄  ▄▄▄▄▄
  4.                  ▐  ▄▄  ▐    ▌  ▐█  █▌ ▐█    █▌ █ ▐▄▄▄▄▄
  5.                  ▐    ▌ ▐▀▀█▀  ▐█    █▌ ▐█  █▌  █       ▌
  6.                   ▀▀▀▀  ▀   ▀  ▀      ▀  ▀▀▀▀   ▀  ▀▀▀▀▀
  7.                  Advanced Gravis Computer Technology Ltd.
  8. 
  9.      Fax (604) 431-5155                   BBS  (604) 431-5927 V32bis
  10.      Compuserve: GO PCVENB (71333,350)    InterNET EMail: tech@gravis.com
  11.      FidoNET: 1:153/978                   SBCNET: 13:900/3
  12.      AOL: Adv Gravis                      Genie: Page M805 Topic 6
  13.  
  14.                ULTRASOUND 32 BIT AIL DRIVERS - 01/29/94
  15.  
  16.  
  17.                    1.0 What are these drivers?
  18.                    2.0 How to 'back patch' games.
  19.                    3.0 Developer information
  20.                    4.0 Revision History
  21.  
  22.  
  23. 1.0.0 ************* CHAPTER 1. - WHAT ARE THESE DRIVERS? *****************
  24.  
  25. This package contains 'IBM Audio Interface Library for 32-bit DOS' (AIL/32)
  26. drivers for the Gravis UltraSound card. This allows developers who use
  27. AIL/32 in their products to easily add native UltraSound support. It also
  28. allows end users to easily 'back patch' products which have shipped without
  29. UltraSound drivers (in effect adding native UltraSound support to games
  30. which have shipped without it).
  31.  
  32. Developers should proceed to chapter 3 and read the information there.
  33.  
  34. Other users should read on. Advanced users may find the developer of some
  35. interest.
  36.  
  37. Some products which use AIL/32 and can be back patched with these drivers
  38. are:
  39.  
  40. IndyCar Racing
  41. Shadow Caster
  42. Sim City 2000
  43. SVGA Air Warrior
  44. Syndicate
  45.  
  46. Notes: IndyCar racing only supports engine noises and tire squeals with
  47.        FM based sound cards. Hence if you use these drivers you will not
  48.        get either of these sound effects. For sound effects use the
  49.        Sound Blaster (TM) drivers with SBOS -o3.
  50.  
  51.        It is unlikely you will be able to use an AdLib compatible card
  52.        at the same time as these drivers, due to timer conflicts between
  53.        the 2 sound cards. This has been requested by several IndyCar
  54.        owners.
  55.  
  56.        Sierra does not use AIL/32 and hence these drivers will not work
  57.        with the latest Sierra 32-bit games. However 32-bit Sierra drivers
  58.        are under development and will be available soon.
  59.  
  60.  
  61. 2.0.0 ************ CHAPTER 2. - HOW TO 'BACK PATCH' GAMES ****************
  62.  
  63. 1.  After installing your game, back up all of the games sound drivers. The
  64.     drivers ususally have the extension .DLL.
  65.  
  66. 2.  Copy the files LOADPATS.EXE and PATCHES.INI into the directory the game
  67.     is installed in.
  68.  
  69. 3.  Copy GUSMID32.DLL over one of the games music drivers (preferably
  70.     a General MIDI driver). The most common names for the music drivers
  71.     are:
  72.  
  73.     A32MT32.DLL    - MT-32/General MIDI driver
  74.     A32SPKR.DLL    - PC Speaker Music driver
  75.     A32ADLIB.DLL   - AdLib Music Driver
  76.     A32ALGFM.DLL   - AdLib Gold Music Driver
  77.     A32SBFM.DLL    - Sound Blaster Music Driver
  78.     A32SP1FM.DLL   - Sound Blaster Pro 1 Music Driver
  79.     A32SP2FM.DLL   - Sound Blaster Pro 2 Music Driver
  80.     A32PASFM.DLL   - Pro Audio Spectrum Music Driver
  81.     A32PASOP.DLL   - Pro Audio Spectrum (OPL3) Music Driver
  82.     A32MT32S.DLL   - MT-32/General MIDI driver (SB MIDI interface)
  83.     A32ARXM.DLL    - ARIA Music Driver
  84.  
  85. 4.  Copy GUSDIG32.DLL over one of the games digital drivers. The most
  86.     common names for the digital drivers are:
  87.  
  88.     A32SBDG.DLL    - Sound Blaster Digital Driver
  89.     A32SBPDG.DLL   - Sound Blaster Pro Digital Driver
  90.     A32PASDG.DLL   - Pro Audio Spectrum Digital Driver
  91.     A32ALGDG.DLL   - AdLib Gold Digital Driver
  92.     A32ARDG.DLL    - ARIA Digital Driver
  93.  
  94. 5.  Run LOADPATS by typing LOADPATS <ENTER>
  95.  
  96. NOTE: The batch file COPYDRVS.BAT provided in this package is designed to
  97.       perform steps 1 to 5 for you automatically PROVIDED the drivers use
  98.       the standard names listed above, or, you are patching Syndicate. In
  99.       particular the game must have one of the following file names:
  100.  
  101.       A32MT32.DLL
  102.       A32SBFM.DLL
  103.       A32SBDG.DLL
  104.  
  105.       To use COPYDRVS type:
  106.  
  107.       COPYDRVS dir_name <ENTER>
  108.  
  109.       where dir_name is the directory where the games sound drivers are
  110.       installed.
  111.  
  112.       e.g.  COPYDRVS C:\INDYCAR <ENTER>
  113.         or  COPYDRVS C:\SC2000\SOUND <ENTER>
  114.         or  COPYDRVS C:\SYND\DATA <ENTER>
  115.  
  116. 6.  Run the game's setup or install software (provided it has one).
  117.     Configure the games sound to use the drivers you copied the
  118.     UltraSound drivers over.
  119.  
  120.     If you used COPYDRVS and it worked, select in the following order:
  121.  
  122.     Sound Blaster for digital, General MIDI for music.
  123.     Sound Blaster for digital, MT-32 for music.
  124.     Sound Blaster for both digital and/or music.
  125.  
  126. Now everytime you run your game:
  127.  
  128. 7.  Run LOADPATS.
  129.  
  130. 8.  Start your game.
  131.  
  132.  
  133. 3.0.0 ************** CHAPTER 3. - DEVELOPER INFORMATION ******************
  134.  
  135. These drivers are for use with the Rational DOS4GW DOS extender only.
  136. Drivers for other platforms can be made available if interest is shown.
  137.  
  138. Files of interest:
  139.  
  140. GUSDIG32.DLL is a PCM sample playback driver. It will play back most forms
  141.   of data except Sound Blaster ADPCM compressed samples.
  142.  
  143. GUSMID32.DLL is an XMIDI driver, designed to play General MIDI sequences.
  144.   By editing PATCHES.INI it can be used to play back sequences for other
  145.   synths (MT-32 sequences for example).
  146.  
  147. LOADPATS.EXE and PATCHES.INI are also required (see below).
  148.  
  149. There are several differences between these drivers and 32 bit AIL drivers
  150. for other cards.
  151.  
  152. * LOADPATS.EXE must be run before either of the drivers will work. This is
  153.   easily accomplished by using a batch file to load your product and
  154.   calling LOADPATS at the start of this batch file. If LOADPATS fails it
  155.   will return a DOS errorlevel of 1, otherwise it returns a 0. You can use
  156.   this to exit from the batch file on an error. The following is an example
  157.   batch file:
  158.  
  159.     @echo off
  160.     loadpats
  161.     if errorlevel 1 goto end
  162.     rungame
  163.     :end
  164.  
  165.   LOADPATS loads patches onto the UltraSound DRAM and sets up several
  166.   parameters on the UltraSound card required for the AIL drivers to
  167.   operate. It is NOT a TSR. Do not run another UltraSound application
  168.   between running LOADPATS and your product.
  169.  
  170. * The drivers ignore hardware parameters passed by AIL_detect_device and
  171.   AIL_init_driver. The hardware parameters are taken from the ULTRASND
  172.   environment variable when LOADPATS is run.
  173.  
  174. * AIL_detect_device will check to make sure LOADPATS has been run.
  175.   However it will not check to see if the hardware irq or DMA settings are
  176.   in conflict with another device. This should not be a problem since the
  177.   ULTRASND environment variable is used for most UltraSound software, and
  178.   hence must be correct for the UltraSound to operate.
  179.  
  180. * The UltraSound drivers WILL work properly with hardware irq's higher than
  181.   7. Other drivers will not due to limitations of the DOS4GW extender.
  182.  
  183. -----------------------------------------------------------------------------
  184. INFORMATION ON LOADPATS:
  185.  
  186. LOADPATS is a simple program which loads the MIDI patches and information
  187. on how to play them onto the UltraSound card. Running LOADPATS gives a
  188. similar functionality as having ROM samples. The patches loaded are
  189. specified in PATCHES.INI, and are loaded in the order specified, until
  190. the UltraSound on board memory is full. Listing only the patches used in
  191. your sequences will result in optimum performance. See the header in
  192. PATCHES.INI for more information on creating a custom .INI file.
  193.  
  194. Command line options:
  195.  
  196. -H -?  Display a help screen.
  197. -16    Load patches at 16 bit instead of 8 bit. This can be usefull if you
  198.        use a custion .INI file which lists only a few patches.
  199. -Mxxx  Set music master volume (relative to digital volume). xxx=1 to 100.
  200.        xxx=90 is the default.
  201. -Iname Specify a different .INI file (instead of PATCHES.INI). 'name' can
  202.        just be a file name, or a complete DOS pathname.
  203. -Q     Disables the screen output.
  204.  
  205. 4.0.0 ***************** CHAPTER 4. - REVISION HISTORY ********************
  206.  
  207. 94/01/20  Corrected a bug in proccessing of text files. This would
  208.           cause LOADPATS to lock up with certain .INI files.
  209.  
  210. 94/01/21  Pressing Ctrl-C while running LOADPATS will no longer leave the
  211.           system unstable (irq's were not getting unhooked).
  212.  
  213.           AIL_detect_device will now use the ULTRASND environment variable
  214.           to get the UltraSound base address. Previously it would probe
  215.           for the base address, causing problems with other hardware
  216.           devices.
  217.  
  218.           Improved documentation.
  219.  
  220. 94/01/25  Drivers are now backward compatible with the older DLLLOAD.C, and
  221.           hence can be used in place of A32MT32.DLL and A32SBDG.DLL etc.
  222.  
  223. 94/01/31  LOADPATS: Will no longer exit to DOS on CTRL-C. Will now use
  224.           (ULTRADIR)\MIDI if the PatchDir field in ULTRASND.INI is invalid.
  225.           Aborts if it encounters an old patch. Corrected a major bug in
  226.           the cross-mapping of the patches. This was causing divide by
  227.           zero errors. Added -L switch to enable UltraSound line in.
  228.  
  229.                             END OF README
  230.